home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / yrndl13.zip / yd.doc < prev    next >
Text File  |  1996-07-20  |  63KB  |  1,589 lines
  1. YD.DOC    20 Jul 1996    (from YRNDL13.ZIP)
  2. (c) 1996 by Jerry Levy    Marblehead, MA USA
  3. jlevy@ibm.net
  4.  
  5. This is the Documentation file for YRNDL13.ZIP.
  6. This is very much in <<Draft>> form at present.
  7.  
  8. This file should be printed at 10 cpi (Courier or other monospaced
  9. font recommented, or a Times font will be acceptable)
  10.  
  11. ABOUT THIS VERSION:  This is version 1.3(beta) of YARNDIAL and
  12. represents a major upgrade.  An installer has been added which supports
  13. fully use of IBM/Advantis' IAK Dialer (for Advantis network only), the
  14. IBM SLIPPM dialer (the Dial-Other-Internet-Providers utility), and
  15. PPP.EXE and SLIP.EXE dialup strings.  It supports use of other dialers
  16. such as the IN-JOY Dialer via dialup strings and has IN-JOY support
  17. "built-in".
  18.  
  19. I plan to issue the final version by October 1, 1996.  This version is
  20. in pretty good shape and the only reason for keeping it beta is that I
  21. hope to enhance third-party dialer support.
  22.  
  23. This program is and will stay freeware.
  24.  
  25. For use of third-party dialers such as IN-JOY, YARNDIAL expects
  26. you to go through the motions of setting up SLIPPM, and we use
  27. the SLIPPM parameter files as repositories for parameters that
  28. YARNDIAL needs in order to run.  SLIPPM is a fine utility, and in
  29. most instances where you are connecting to a provider other than
  30. Advantis and you need to make a SLIP or PPP connection, it, used
  31. alone or with add-on script packages such as PPPDIAL28, will work
  32. adequately.  
  33.  
  34. I am committed to adding and improving support of third-party
  35. dialers provided I can obtain a copy to work with and the interface
  36. is not obscure.  Contact me if I do not support your pet dialer.
  37.  
  38.             CONTENTS
  39. 1.00   Installation For The Impatient User (assumes Yarn and 
  40.         Souper are Installed And They Work
  41. 2.00   What Is Yarndial?
  42. 3.00   Key Features
  43. 4.00   Copyright Notice and Disclaimers
  44. 5.00   Passwords - Disclaimer
  45. 6.00   How Does the Installer Work?
  46. 7.00   Example: Setting Up For Two Users (My Installation)
  47. 8.00   What Does YDINSTL.CMD Do?
  48. 9.00   .CMD Files Created - Meaning of Customization 
  49. 10.00  Recreating Objects (running OBJECTS.CMD - A Peculiarity
  50. 11.00  Warp Connect, Souper, YARN: Versions Tested
  51. 12.00  You Have Not Installed Yarn and Souper Yet?
  52. 13.00  History
  53. 14.00  Should You Upgrade Anything Before You Install?
  54.         14.10   Souper
  55.         1420    IBM/Advantis IAK Dialer
  56.         14.30   SLIPPM.EXE (Dial-Other-Internet-Providers Utility 
  57.                  and SLIP Upgrades
  58. 15.00  Before You Run YDINSTL.CMD
  59. 16.00  Notes On Using The IN-JOY Dialer
  60. 17.00  About The Fix-Interrupted-Import Option On The Main
  61.         YARNDIAL Menu
  62. 18.00  Souper Command-Line Options
  63. 19.00  Questions That May Come Up During Or After Install
  64. 20.00  Manual Install
  65. 21.00  Manual Install: The Password Problem
  66. 22.00  Connection-Type: the Seven Connection-Type Choices
  67. 23.00  More About Dialup_String: A Programming Note
  68. 24.00  Zip and UnZip Files
  69. 25.00  Compression Executables: OS/2 Versus MS-DOS 
  70. 26.00  Some Other Breed Of Compression Utilities
  71. 27.00  Setting Up Yarn And Souper From Scratch
  72. 28.00  Install EMXRT, METAMAIL, MIME64 (recommended)
  73.         28.10 EMXRT09B (optional)
  74.         28.20 METAMAIL (optional)
  75.         28.30 MIME64 (optional) 
  76. 29.00  Step-By-Step Installation Of Yarn And Souper
  77. 30.00  Note About Adding Newsgroups
  78. 31.00  Setting Up And Installing For Multiple Users
  79. 32.00  Where To Get Software
  80. 33.00  Where To Find Helpful Documentation
  81. 34.00  Bugs
  82.  
  83.  
  84. 1.00INSTALLATION FOR THE IMPATIENT USER (ASSUMES YARN AND SOUPER 
  85. ARE INSTALLED AND THEY WORK)
  86.     1.10    First unzip YRNDL13.ZIP into a temporary folder.  You 
  87. have probably done that if you are reading this.
  88.  
  89. The archive is YRNDL13.ZIP
  90.  
  91. Files in the archive are
  92.     FILE.DIZ        Zipfile Description
  93.     README.1ST        A lot shorter than YD.DOC
  94.     YD.DOC        This file
  95.     YDINSTL.CMD        The installer
  96.     YARNDIAL.CMD    
  97.     GO.EXE        From GO_15.ZIP, needed by YARNDIAL
  98.     GO_15.ZIP        Please open at your leisure, read     
  99.                 the documentation and send Carsten     
  100.                 his postcard.
  101.     an \ICONS\ subdirectory containing all of the icons 
  102.     needed
  103.  
  104. If you unzipped YRNDL13.ZIP with PkZip without using the -d 
  105. option, you will not have a subdirectory named ICONS.  That 
  106. will not interfere with installation.  YDINSTL will manage 
  107. to find the icons.
  108.  
  109.     1.20    Double-click on YDINSTL.CMD and follow the 
  110. instructions in screen prompts.
  111.  
  112.  
  113. 2.00  WHAT IS YARNDIAL?
  114. YARNDIAL.CMD is a menu-driven front end for C.T. Huang's 
  115. OS/2 Souper and Yarn off-line News and Mail 
  116. reader/management programs.  YARNDIAL is a ReXX utility 
  117. running under OS/2 Warp.  It is designed to automate the 
  118. steps needed to retrieve and send news articles and mail and 
  119. while doing so to provide a more versatile, friendlier 
  120. interface for users than could be accomplished using 
  121. ordinary batch files.
  122.  
  123. YARNDIAL v. 1.3 and its installer (YDINSTL.CMD) should work 
  124. with any version of OS/2 Warp.  ReXX must  installed for 
  125. YARNDIAL and its installer to run.  Yarn and Souper must 
  126. also be correctly installed since YARNDIAL functions as a 
  127. front end for Souper and interfaces with Yarn.
  128.  
  129. YARNDIAL's opening menu allows you seven choices:
  130.  
  131. 1  Only import Mail
  132. 2  Only import News Articles
  133. 3  Only import, but both Mail AND News
  134. 4  Only export (send Mail, Posts, Replies, and Follow-ups)
  135. 5  Everything: Get mail and news AND send Posts, Replies, 
  136.    and Follow-ups
  137. 6  Complete an interrupted importation of mail/news
  138.    or rebuild a corrupted YARN history file
  139. 7  Souper options:  one-time-only changes in how Souper 
  140.    runs:
  141.       Catchup on News
  142.       Maximum News Packet Size
  143.       Do not retrieve newsgroup articles Longer than set 
  144.          number of lines
  145.       Read-only for Mail: Don't empty POP3 Mailbox
  146.  
  147.  
  148. 3.00  KEY FEATURES
  149. o  Automatic dialup, connection, retrieval and sending of 
  150. news and/or mail, and signoff
  151.  
  152. o Ability under certain circumstances to operate for a SLIP 
  153. or PPP connection that happens to be established to a 
  154. provider
  155.  
  156. o  Ability to use a variety of dialup and connect options.    
  157. Supported are: the IBM/Advantis IAK Dialer,  IBM's Dial-
  158. Other-Internet-Providers utility (SLIPPM.EXE),  PPP.EXE and 
  159. SLIP.EXE dialup strings, and the IN-JOY dialer (only in-joy 
  160. v. 09 tested so far)
  161.  
  162. o  Menu-driven, for convenient selection of tasks
  163.  
  164. o  Ability to choose/change a limited number of Souper 
  165. command-line options (menu, during install)
  166.  
  167. o  Ability to choose/change some Souper command-line options 
  168. (menu, when running YARNDIAL)
  169.  
  170. o  A YARNDIAL menu item which allows you to complete an 
  171. importation of news or mail which had been interrupted,  and 
  172. to call up the Yarn utility REBUILD to restore damaged Yarn 
  173. spool and history files  (You don't need to understand this:  
  174. if you were downloading news and mail and it never showed 
  175. up, or your machine quit in the middle, or the lights went 
  176. out, maybe this will provide a fix)
  177.  
  178. o  YDINSTL.CMD provides a near-automated (prompted) 
  179. installation process if you already have installed Yarn and 
  180. Souper and they work
  181.  
  182. o  Ability of YARNDIAL to grab and use an existing SLIP or 
  183. PPP connection, or an existing PPP0 or SL0 interface.  This 
  184. has only been tested with connections initiated by 
  185. SLIPPM.EXE (includes SLIP.EXE and PPP.EXE), a connection 
  186. established by the IBM/Advantis IAK Dialer, or one 
  187. established by the IN-JOY dialer.
  188.  
  189. o  Some ability exists to discriminate if the connection 
  190. that is up is the correct connection for the particular user 
  191. for which YARNDIAL was installed.  This presently only 
  192. partially applies to the IN-JOY dialer.  I hope through 
  193. communication with the author of IN-JOY to work out details 
  194. for improved validation procedures.
  195.  
  196. o  Ability when you run YARNDIAL to select read-only for 
  197. mail retrieval (doesn't empty your POP3 mailbox).  I did not 
  198. extend this to read-only for news retrieval (i.e., to 
  199. prevent your NEWSRC file from updating).  You can edit the 
  200. Souper parameters in YD_PARMS.DAT file following 
  201. installation to achieve this end (add -r to the 
  202. getnews_xtra_options element).
  203.  
  204. o  Ability when you run YARN